home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / pcpil / updates.doc < prev   
Text File  |  1994-02-23  |  10KB  |  218 lines
  1. Documentation NOTES FOR PC/PILOT VERSION 4.4   
  2.  
  3. The supplied manual matches PC/Pilot version 4.0. The following
  4. notes provide information on changes to the product since that
  5. version.
  6.  
  7. New Features in PC/PILOT Version 4.4
  8.  
  9. - E:label   when a label is put on an end statement, after the Use stack
  10.             is popped, a search is made for the label. In previous versions,
  11.             if the label is not found, an error message is produced. In
  12.             version 4.4, if the label is not found, the Use stack is popped
  13.             again, thereby returning one more Use level, then another
  14.             search is performed for the label. This process repeats until
  15.             the label is found, or the program has returned all the way
  16.             to the lowest use level. In that case, an error message is
  17.             displayed and the program returns (to DOS).
  18.  
  19.             This feature can be used to return out an indefinite number
  20.             of levels to a menu or other main branch point.
  21.  
  22. - Command-line arguments - Upon entry to a Pilot program, the command
  23.             line arguments can be found in %B, the answer buffer. This
  24.             includes all the items after, but not including, the PI or
  25.             CPI command that started Pilot. Each command line argument
  26.             is followed by a single space in %B. For example, the
  27.             command:   "PI myprog 6  This is    IT" would enter the
  28.             program "myprog" with %B="myprog 6 This is IT "
  29.  
  30.  
  31. New Features in PC/PILOT Version 4.3
  32.  
  33. Version 4.3 follows version 4.1. There is no version 4.2. Version 4.3 is 
  34. compiled with a newer optimizing version of Microsoft C, resulting in a    
  35. slightly smaller executable code size and about a 10% improvement in 
  36. typical program execution speed.
  37.  
  38. New feature summary:
  39.  
  40. - Support of some MCGA and VGA graphics modes
  41.  
  42. - Accepts E-notation for numbers (example:   C: x = 12.34e12 + 3.23e-5 )
  43.  
  44. - LX: op code to clear all variable from the variable table on a Link.
  45.   Adding the X modifier to the L: command causes all variables to be
  46.   discarded in the process of the Link operation. Example:   LX:part2
  47.  
  48. - Timing -- The delays used for animation of text and sprites, and
  49.   for the sound command have been normalized so that they should
  50.   produce reasonably similar results on any model computer.
  51.  
  52. The main new feature in this release is the support of MCGA and VGA 
  53. graphics modes. The new mode numbers are as follows:
  54.  
  55. TS:M17  - sets the 640 x 480 pixel, 2-color graphics mode. 
  56.  
  57. TS:M18  - sets the 640 x 480 pixel, 16-color graphics mode. 
  58.  
  59. TS:M19  - sets the 320 x 200 pixel, 256-color graphics mode. 
  60.  
  61. Modes 17 and 19 are available on all PS-2 models whether they have
  62. MCGA or VGA adapters. Mode 18 is not available on MCGA, only VGA.
  63.  
  64. In all three modes PC/PILOT supports normal text operations, and
  65. vector/turtle graphics commands of the G: statement. So you can
  66. type text using the standard character set, define viewports, set
  67. text color, etc. Graphics commands such as Forward, Right, Left,
  68. Draw, Color and Line Width select, Arc and Paint can be used.
  69. These modes do not support the setting of a background color.
  70.  
  71. Modes 17 and 19 suppport GSX: and GX: commands without a file name
  72. argument. That is, you can save and restore to memory only.
  73.  
  74. Modes 17 and 19, but not 18, also support font output of text and
  75. the use of sprites. You need AFL 4.3 to create the sprite files for
  76. these modes.
  77.  
  78. You can display full or partial PCX graphic images in modes 17 and 19
  79. using any one of several display wipes/fades. Picture display requires
  80. AFL 4.3.
  81.  
  82. -------------------------------------------------------------------------------
  83.  
  84. Features that were new in PC/PILOT Version 4.1
  85.  
  86. - The environment symbol PIPATH can be used to direct PILOT to search multiple
  87.   directories for PILOT files. PIPATH is for PILOT programs what PATH is for
  88.   DOS programs. PIPATH is initialized via the DOS SET command, for example:
  89.  
  90.      SET PIPATH=A:;B:
  91.  
  92.   would cause PILOT to always search disk A:, then B: when a needed file is
  93.   not found in the current working directory. The format of PIPATH is similar
  94.   to that of PATH. It may be a list of drive and/or directory names, each
  95.   one separated from the next by a semi-colon. Another example:
  96.  
  97.      SET PIPATH=C:\PART1;C:\PART2 
  98.  
  99.   You can use PIPATH to aid the separation of a PILOT program onto two
  100.   diskettes, or into several directories. It could also be used to increase
  101.   execution speed by placing the most critical PILOT modules in a ram-disk,
  102.   leaving the remaining files on a real disk. In this case, make the ram
  103.   disk the current working directory and use PIPATH to refer to the files
  104.   on the real disk.
  105.  
  106.   The function of PIPATH is automatic and takes no special programming in
  107.   the PILOT program. Whenever a ".PIL" file is to be loaded due to a
  108.   LINK or USE statement the current directory is searched first. Then,
  109.   if the file is not found, and PIPATH has been set, the directories on
  110.   the PIPATH are searched in order. PIPATH is also in effect for the
  111.   FJ: and FJX: statements which are used to load pictures, binary files,
  112.   sprites and fonts. PIPATH is NOT in effect for the FX: statement.  
  113.  
  114. - The VX: statement is now used to call DOS programs from within your PILOT
  115.   program. Prior to this version, EXEC was used for this. You should no longer
  116.   use EXEC with version 4.1 or higher. Instead, use the VX: statement,
  117.  
  118.      FORMAT   -    VX:string-expression 
  119.  
  120.      Example  -    VX:"DIR"
  121.  
  122.      Example  -    C: CMD$ = "BASIC HELLO"
  123.                    VX: CMD$
  124.  
  125.    Old PILOT programs that used EXEC.BIN can still be used provided that the
  126.    new file EXEC.BIN from AFL version 4.2 or higher is used. Also note that
  127.    it is a larger file so the string variable may need to be longer.
  128.  
  129. - To determine the PC/PILOT version number, enter the command PI, or CPI 
  130.   with no program name after it. In a version prior to 4.1 you just get an
  131.   error message "missing program name". In version 4.1 or higher you will
  132.   see a version number displayed.
  133.  
  134. - Version 4.1 permits up to 220 variable names and up to 500 label names  
  135.   (label names are cleared by a L: statement).
  136.  
  137. - EGA sprite files no longer have the suffix ".SPR". In order to distinguish
  138.   them from CGA sprite files, the suffix ".SPE" is now used for EGA sprites.
  139.   This is the suffix expected by EGASE.       
  140.  
  141. - Due to conflict with Windows "Program Information Files", PILOT font files
  142.   now use the suffix ".FMF" rather than ".PIF".
  143.  
  144. - To make greater use of memory, you can load fonts, sprite tables and PIQ 
  145.   images into memory outside of your string space. To do so use the command:
  146.  
  147.      FJX: var$,"filename"
  148.  
  149.   This works like the FJ: statement found in the version 4.0 manual except
  150.   that adding the X modifier causes the string variable to be created from
  151.   memory external to PILOT to save string space for other uses. You can
  152.   use these external strings only for fonts, sprite tables and pictures to
  153.   be displayed via PIQSHOW. See the documentation for PIQSHOW to determine
  154.   the different calling parameters which must be used.
  155.  
  156. - LWR(x$) is a new built-in function which returns the lower case value of
  157.   string x$.
  158.  
  159. - INS(x$,y$,z)  When INS has three arguments, the first is the source string,
  160.   the second is the search string, and the third is the substring location
  161.   in x$ where the search is to begin. If the search string is found at or
  162.   after position z in the source string, the position value is retured. Other-
  163.   wise a value of zero is returned. This is an extension of the INS function
  164.   in the manual.
  165.  
  166. - SWP(x$,y$)  When SWP has three arguments, the first is the source string,
  167.   the second is the search character, and the third is the replacement
  168.   character. the function returns a string equal to the source string with
  169.   all occurances of the search character replaced by the replacement character.
  170.  
  171. - BWA(x$,y$) is a new built-in function which returns the one-character
  172.   string resulting in the bit-wise binary AND of the two string characters
  173.   found as the first characters in string x$ and string y$.
  174.  
  175. - After any string assignment statement the system variable %LEN contains
  176.   the length of the assigned string.
  177.  
  178. - The semi-colon may be used in place of a comma in D: statements, between
  179.   string names.
  180.  
  181. - Numeric arrays are initialized to all zeros when created.
  182.  
  183. - The two character sequence  #\  is not displayed when found in the text
  184.   of a type statement. This sequence is used as a marker by the ProPi
  185.   authoring system.
  186.  
  187. - A label consisting of only an asterisk, "*", is called a "null label".
  188.   A JUMP statement can specify a jump to the last null label passed. Thus
  189.   more than one null label can appear in a program without conflict. The
  190.   advantage of the null label is that it does not use up of the 500 possible
  191.   labels. It is used when a short loop is to be coded. For example:
  192.  
  193.      C:I=1
  194.      *
  195.      th:#I, 
  196.      C:I=I-1
  197.      J(I<10):*
  198.  
  199. - Items missing or in error in the version 4.0 manual:
  200.  
  201.     - When using an extended (256-character font) character 0 must be blank.
  202.  
  203.     - The rectangle command -  TS:R0,x,y  in all graphic modes (greater than
  204.       or equal to 4) displays a solid box of the current foreground color
  205.       using the character typed by "F6 [" in EZ. To make this work right
  206.       you must include an N: statement defining this character to all one
  207.       bits (64 "/" characters).
  208.  
  209.     - The maximum duration for a sound in the S: statement is 255, not 63.
  210.  
  211.     - When a U: statement is executed, the last Accept location (as in
  212.       J:@A ) is stacked along with the return point. When the subroutine
  213.       returns, the last Accept location is restored. So the location of
  214.       the last Accept is always relative to the current subroutine.
  215.  
  216. End of list of features new in version 4.1
  217.  
  218.